1   /*
2    * Copyright (C) 2007 The Guava Authors
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    * http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package com.google.common.collect.testing;
18  
19  import com.google.common.annotations.GwtCompatible;
20  import com.google.common.collect.testing.SampleElements.Strings;
21  
22  import java.util.List;
23  import java.util.Set;
24  
25  /**
26   * Create string sets for collection tests.
27   *
28   * @author Kevin Bourrillion
29   */
30  @GwtCompatible
31  public abstract class TestStringSetGenerator implements TestSetGenerator<String>
32  {
33    @Override
34    public SampleElements<String> samples() {
35      return new Strings();
36    }
37  
38    @Override
39    public Set<String> create(Object... elements) {
40      String[] array = new String[elements.length];
41      int i = 0;
42      for (Object e : elements) {
43        array[i++] = (String) e;
44      }
45      return create(array);
46    }
47  
48    protected abstract Set<String> create(String[] elements);
49  
50    @Override
51    public String[] createArray(int length) {
52      return new String[length];
53    }
54  
55    /**
56     * {@inheritDoc}
57     *
58     * <p>By default, returns the supplied elements in their given order; however,
59     * generators for containers with a known order other than insertion order
60     * must override this method.
61     *
62     * <p>Note: This default implementation is overkill (but valid) for an
63     * unordered container. An equally valid implementation for an unordered
64     * container is to throw an exception. The chosen implementation, however, has
65     * the advantage of working for insertion-ordered containers, as well.
66     */
67    @Override
68    public List<String> order(List<String> insertionOrder) {
69      return insertionOrder;
70    }
71  }